home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / dev / e / jrhrkrm2.readme < prev   
Text File  |  1995-10-10  |  8KB  |  161 lines
  1. Short:    E versions of RKRM examples (Part Two)
  2. Author:   jason@fsel.com (Jason R. Hulance)
  3. Uploader: jason@fsel.com (Jason R. Hulance)
  4. Type:     dev/e
  5.  
  6. JRH's RKRM Examples (Part Two)
  7. ==============================
  8.  
  9. (Part One of my RKRM translations are available from the same place
  10. you got this, or as part of the v3.2a distribution of Amiga E.)
  11.  
  12. This archive contains translations of all the examples from the
  13. following chapters of the RKRM (Libraries): Expansion, Graphics (all
  14. the corresponding chapters), IFFParse, Keymap, Math (minus the FFP
  15. examples) and Utility.  Also included are translations of all the
  16. examples from the following chapters of the RKRM (Devices): Clipboard
  17. and Console.
  18.  
  19. The examples retain most of the original comments, with comments
  20. specific to these E versions beginning "-> E-Note:".  A lot of effort
  21. has been put into showing how to effectively use E features such as
  22. exceptions and lists.  A number of bugs in the original examples have
  23. also been eliminated.
  24.  
  25. If you are new to E you should pay special attention to the effect of
  26. using exceptions: error handling and clean-up are neatly separated
  27. from the main code, and the code is generally much less indented.  You
  28. should also notice the special care taken to initialise variables
  29. appropriately so that clean-up is made much more simple in the
  30. handlers.
  31.  
  32. Two standard support modules have been bug-fixed and included with
  33. this archive.  They are 'tools/longreal' and 'tools/inithook' (which
  34. is a replacement for 'tools/installhook').  The 'longreal' module had
  35. the following problem: dFormat() did not print negative floats
  36. properly (especially fractions between -1 and 0).  The 'installhook'
  37. module needlessly used the 'data' element of a hook for its own
  38. purposes.  'inithook' does not do this, and allows you to use an
  39. optional third argument to specify the 'data' for your hook.
  40.  
  41. If you wish to recompile the sources (I expect you might...), you will
  42. need my Typed Modules (V40), my AmigaLib modules and my UsefulV2
  43. modules.  These archives should all be available where you found this
  44. archive (Aminet? In 'dev/e'?.  Most are also part of the v3.2a
  45. distribution of Amiga E.
  46.  
  47. These executables, E sources and E modules are all Copyright (C) 1995,
  48. Jason R. Hulance.
  49. The original RKRM examples are Copyright (C) 1992, Commodore-Amiga Inc.
  50.  
  51. You are free to use the files in this archive to help create your own
  52. programs (whether they are freeware or commercial), but if you wish to
  53. distribute any part of this archive you must include it all,
  54. unmodified, and with this file.
  55.  
  56. (Hopefully, there will be a Part Three which will contain the
  57. remainder of the RKRM examples.)
  58.  
  59.  
  60. ============================= Archive contents =============================
  61.  
  62. Original  Packed Ratio    Date     Time    Name
  63. -------- ------- ----- --------- --------  -------------
  64.     2651    1276 51.8% 21-Sep-95 08:28:48  JRH-RKRM-2.readme
  65.        0       0  0.0% 21-Sep-95 08:28:20 +
  66.        0       0  0.0% 21-Sep-95 08:28:20 +
  67.      178     141 20.7% 20-Sep-95 20:16:00 +inithook.m
  68.     6846    1937 71.7% 20-Sep-95 20:17:14 +longreal.m
  69.        0       0  0.0% 21-Sep-95 08:28:26 +
  70.        0       0  0.0% 21-Sep-95 08:28:20 +
  71.     8230    2948 64.1% 20-Sep-95 22:58:38 +cbio.e
  72.     2948    1259 57.2% 20-Sep-95 22:58:38 +cbio.m
  73.     4988    2313 53.6% 20-Sep-95 22:58:38 +changehook_test
  74.     2216     956 56.8% 20-Sep-95 22:58:38 +changehook_test.e
  75.     7712    3406 55.8% 20-Sep-95 22:58:38 +clipdemo
  76.     6505    2360 63.7% 20-Sep-95 22:58:38 +clipdemo.e
  77.        0       0  0.0% 21-Sep-95 08:28:20 +
  78.     1961     876 55.3% 20-Sep-95 20:14:36 +AskKeymap.e
  79.     8049    3006 62.6% 20-Sep-95 20:14:36 +Console.e
  80.     1732    1137 34.3% 20-Sep-95 20:14:36 +askkeymap
  81.     4052    2165 46.5% 20-Sep-95 20:14:36 +console
  82.        0       0  0.0% 21-Sep-95 08:28:22 +
  83.     2096    1236 41.0% 20-Sep-95 20:14:36 +findboards
  84.     2377     984 58.6% 20-Sep-95 20:14:36 +findboards.e
  85.        0       0  0.0% 21-Sep-95 08:28:22 +
  86.     8863    2902 67.2% 20-Sep-95 20:14:36 +Absolute_Joystick.e
  87.     4700    2292 51.2% 20-Sep-95 20:14:36 +absolute_joystick
  88.        0       0  0.0% 21-Sep-95 08:28:24 +
  89.        0       0  0.0% 21-Sep-95 08:28:22 +
  90.     1996    1223 38.7% 20-Sep-95 20:14:36 +clipping
  91.     4568    1673 63.3% 20-Sep-95 20:14:36 +clipping.e
  92.     6416    2567 59.9% 20-Sep-95 20:14:36 +layers
  93.    11252    3023 73.1% 20-Sep-95 20:14:36 +layers.e
  94.        0       0  0.0% 21-Sep-95 08:28:22 +
  95.     6978    2795 59.9% 20-Sep-95 20:14:38 +RGBBoxes.e
  96.     9520    3260 65.7% 20-Sep-95 20:14:38 +WBClone.e
  97.     5868    2549 56.5% 20-Sep-95 20:14:36 +genlockdemo
  98.    14775    4620 68.7% 20-Sep-95 20:14:38 +genlockdemo.e
  99.     2912    1634 43.8% 20-Sep-95 20:14:36 +rgbboxes
  100.     2164    1352 37.5% 20-Sep-95 20:14:36 +usercopperexample
  101.     4729    1883 60.1% 20-Sep-95 20:14:38 +usercopperexample.e
  102.     4296    2146 50.0% 20-Sep-95 20:14:36 +wbclone
  103.        0       0  0.0% 21-Sep-95 08:28:24 +
  104.    13095    3995 69.4% 20-Sep-95 20:14:38 +animtools.e
  105.     4640    1884 59.3% 20-Sep-95 20:14:38 +animtools.m
  106.     5928    2648 55.3% 20-Sep-95 20:14:38 +bob
  107.     4116    1733 57.8% 20-Sep-95 20:14:38 +bob.e
  108.    11052    4878 55.8% 20-Sep-95 20:14:38 +collide
  109.    20518    6810 66.8% 20-Sep-95 20:14:38 +collide.e
  110.     1940    1224 36.9% 20-Sep-95 20:14:38 +ssprite
  111.     3595    1432 60.1% 20-Sep-95 20:14:38 +ssprite.e
  112.     7312    3171 56.6% 20-Sep-95 20:14:38 +vsprite
  113.     5504    2172 60.5% 20-Sep-95 20:14:38 +vsprite.e
  114.        0       0  0.0% 21-Sep-95 08:28:24 +
  115.     6767    2578 61.9% 20-Sep-95 20:14:38 +MeasureText.e
  116.     6012    2553 57.5% 20-Sep-95 20:14:38 +availfonts
  117.     9701    2979 69.2% 20-Sep-95 20:14:40 +availfonts.e
  118.     4148    2081 49.8% 20-Sep-95 20:14:38 +cliptext
  119.    10782    3821 64.5% 20-Sep-95 20:14:38 +cliptext.e
  120.     4248    2254 46.9% 20-Sep-95 20:14:38 +measuretext
  121.        0       0  0.0% 21-Sep-95 08:28:24 +
  122.     4040    2349 41.8% 20-Sep-95 20:14:40 +clipftxt
  123.     5498    2224 59.5% 20-Sep-95 20:14:40 +clipftxt.e
  124.     3148    1849 41.2% 20-Sep-95 20:14:40 +sift
  125.     5535    2358 57.3% 20-Sep-95 20:14:40 +sift.e
  126.        0       0  0.0% 21-Sep-95 08:28:24 +
  127.     6074    2240 63.1% 20-Sep-95 20:14:40 +appkeymap.e
  128.     2128    1004 52.8% 20-Sep-95 20:14:40 +appkeymap.m
  129.     2136    1274 40.3% 20-Sep-95 20:14:40 +mapansi
  130.     2750    1027 62.6% 20-Sep-95 20:14:40 +mapansi.e
  131.     1912    1286 32.7% 20-Sep-95 20:14:40 +maprawkey
  132.     2568    1093 57.4% 20-Sep-95 20:14:40 +maprawkey.e
  133.        0       0  0.0% 21-Sep-95 08:28:26 +
  134.     6524    2146 67.1% 20-Sep-95 20:14:40 +dpieee
  135.      768     452 41.1% 20-Sep-95 20:14:42 +dpieee.e
  136.     6540    2162 66.9% 20-Sep-95 20:14:40 +dptrans
  137.      735     429 41.6% 20-Sep-95 20:14:42 +dptrans.e
  138.     1488    1075 27.7% 20-Sep-95 20:14:40 +spieee
  139.      868     465 46.4% 20-Sep-95 20:14:40 +spieee.e
  140.     1416    1051 25.7% 20-Sep-95 20:14:40 +sptrans
  141.      895     497 44.4% 20-Sep-95 20:14:40 +sptrans.e
  142.        0       0  0.0% 21-Sep-95 08:28:26 +
  143.     1916    1243 35.1% 20-Sep-95 20:14:42 +a2d
  144.     1394     609 56.3% 20-Sep-95 20:14:42 +a2d.e
  145.     1036     772 25.4% 20-Sep-95 20:14:42 +hooks1
  146.      986     502 49.0% 20-Sep-95 20:14:42 +hooks1.e
  147.     1256     881 29.8% 20-Sep-95 20:14:42 +istr
  148.      902     491 45.5% 20-Sep-95 20:14:42 +istr.e
  149.     1232     792 35.7% 20-Sep-95 20:14:42 +tag1
  150.     2158     782 63.7% 20-Sep-95 20:14:42 +tag1.e
  151.     1976    1221 38.2% 20-Sep-95 20:14:42 +uptime
  152.     1670     739 55.7% 20-Sep-95 20:14:42 +uptime.e
  153.        0       0  0.0% 21-Sep-95 08:28:26 +
  154.        0       0  0.0% 21-Sep-95 08:28:26 +
  155.        0       0  0.0% 21-Sep-95 08:28:26 +
  156.      662     353 46.6% 20-Sep-95 20:14:34 +inithook.e
  157.        0       0  0.0% 21-Sep-95 08:28:26 +
  158.     9875    1880 80.9% 20-Sep-95 20:14:42 +longreal.e
  159. -------- ------- ----- --------- --------
  160.   351022  141378 59.7% 23-Sep-95 04:37:08   95 files
  161.